<html>
	<head>
		<title>Perspective</title>
		<link rel="STYLESHEET" href="book.css" charset="ISO-8859-1" type="text/css"/>
	</head>
	<body>
		<h2>Perforce Perspective</h2>
		
		<p>
			The p4eclipse plugin provides a number of views on the perforce operations, that 
			can be added to any eclipse perspective. The default Perforce perspective has all 
			the available p4eclipse views active.
		</p>
				
		<h3>
			<a name="ClientView">Client View of Perforce Depot</a>
		</h3>
		    
		    <p>
		    	The <span class="viewTitle">Client View of Perforce Depot</span> displays a list of all 
		    	the client views that have been defined within p4eclipse. 
		    </p>
		    <p>
		    	A new client view can be created by right-clicking on the view background, and 	
		    	selecting <span class="menu">New->Perforce&nbsp;Server</span>. The 
		    	<a href="#PerforceServer">Add Perforce Server</a> dialog will appear, where all 
		    	necessary data to reach a particular Client View on a specific server can be
		    	entered.		    	
		    </p>    
			    
			<div class="dialogBlock">
		       <h3><a name="PerforceServer">Perforce Server</a></h3>
		   		The <span class="dialogTitle">Add Perforce Server</span> dialog asks for the following:
	
		   		<table class="dialogDescription">
		   			<tr>
		   				<th>Dialog Label</th>
		   				<th>Perforce Equivalent</th>
						<th>Description</th>
		   			</tr>
		   			<tr>
		   				<td>Connection</td>
		   				<td>P4PORT</td>
						<td>The hostname and port of your Perforce server, 
							ie. <b>perforce.yourdomain.com:1666</b>  Note that in p4eclipse
							this is broken up into several fields.</td>
		   			</tr>
		   			<tr>
		   				<td>Client</td>
		   				<td>P4CLIENT</td>
						<td>The name of the Perforce client view that you want to use.</td>
		   			</tr>
		   			<tr>
		   				<td>Host</td>
		   				<td>P4HOST</td>
						<td>The name of the host your client expects.  Usually the
							name of this host.</td>
		   			</tr>
		   			<tr>
		   				<td>User</td>
		   				<td>P4USER</td>
						<td>Your user name for this Perforce server.</td>
		   			</tr>
		   			<tr>
		   				<td>Password</td>
		   				<td>P4PASSWD</td>
						<td>The password to use for this username.</td>
		   			</tr>
		   			<tr>
		   				<td>Character Set</td>
		   				<td>&nbsp;</td>
						<td>The character set used in the communication with the Perforce server</td>
		   			</tr>
		   		</table>
		   		
		   		<p>
			   		Additionally, there are two checkboxes.  The <i>Include when performing background 
			   		updates</i>	does exactly what it says. See 
			   		<a href="BackgroundUpdates.html">Background	Updates</a>.
		   		</p>
		   		<p>
			   		<i>Validate Connection on Finish</i> checks that the information 	
			   		given in the dialog is correct,	before it is saved.
			   	</p>
			</div>
	   
	   		<p>
	   			The <span class="viewTitle">Client View of Perforce Depot</span> also allows you to 
	   			<a href="PerforceOperations.html#CheckoutProject">check out a project</a>, and to
	   			discard a server (by <b>right clicking the server</b> and selecting 
	   			<span class="menu">Discard&nbsp;Server</span>
	   		</p>
	   		
	   <h3>
	   		<a name="PendingChangelists">Pending Changelists view</a>
	   </h3>
	   
	   		<p>
	   			The <span class="viewTitle">Pending Changelists</span> view shows both yours and others
	   			pending changelists, grouped per client view.
	   		</p>
	   		<p>
	   			From within the <span class="viewTitle">Pending Changelists</span> view one can 
	   			<a href="PerforceOperations.html#SubmitChangelist">submit changelists</a>, 
	   			<a href="PerforceOperations.html#EditChangelist">edit changelists</a>, and
	   			<a href="PerforceOperations.html#ResolveConflict">resolve conflicts</a> for a
	   			changelist.
	   		</p>
	   	
	   <h3>
	   		<a name="PerforceConsole">Perforce Console</a>
	   	</h3>
	   
	   		<p>
	   			In the <span class="viewTitle">Perforce Console</span> all perforce operations the
	   			p4eclipse plugin performs are logged with a timestamp and the corresponding perforce
	   			command-line syntax for that operation.
	   		</p>
	   
	   <h3>
	   		<a name="RevisionHistory">Revision History</a>
	   	</h3>
		<p>
			When browsing though a depot in the 
			<span class="viewTitle">Client View of Perforce Depot</span>, the revision history of a
			file can be requested by <b>right clicking on the filename</b> and selecting 
			<span class="menu">Show&nbsp;in&nbsp;Revision&nbsp;History</span>. The <span
			class="viewTitle">Revision&nbsp;History</span> view will now be opened if it wasn't
			open already, and show the rivision history of the selected file.
		</p>
		<p>
			The Revision History view that is shown is divided into three sections. The upper 
			section is the list of revisions for the selected file, the lower left displays 
			the action that was performed on the file for the selected revision, and on the 
			lower right side the comment for that revision is printed.
		</p>
	</body>
</html>